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C.1  Introduction 

The  radio  perframance  nMmitor  (radmon)  is  a  program  for  monitoring  and  analyzing  the  performance 
of  the  SINCGAKS  radio  simulation  for  SIMNET.  Radmon  monitras  traffic  on  the  simulation 
network  and  records  infonnation  broadcast  by  the  SINCGARS  radio  simulator  hosts  concerning  every 
important  state  change  of  every  simulated  radio.  For  example,  when  the  channel  selection  knob  on  a 
radio  is  turned  to  a  diflerent  channel,  the  SINCGARS  radio  simulator  broadcasts  a  TransmitteiPDU 
giving  the  new  frequency  selection  for  that  radio.  Radmon  receives  the  transmission  and  records 
which  radio  changed  state,  the  nature  of  the  change,  and  the  time  at  which  the  chan^  >  occurred. 
Radmon  maintains  a  tunning  history  of  these  state  changes  for  each  tadia 

The  information  that  radmon  records  can  be  saved  in  a  file  and  subsequently  restc.cd  from  that  file. 
Radmon  allows  the  user  'o  browse  through  the  recorded  data  to  examine  intera'.tion.  in  detail.  The 
recorded  data  can  also  be  summarized  to  show  channel  utilization,  radio  utilization,  and  other 
statistics  of  radio  activity. 

The  collected  information  can  be  presented  in  several  ways.  A  stripchart  display  shows  the  activity 
of  radios  as  a  function  of  time.  A  connectivity  map  shows  the  the  communication  paths  that  are 
usable.  A  status  display  shows  the  detailed  state  of  individual  radios.  ^ 
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C.2  Summary  of  SINCGARS  Radio  Simulation 

The  simulaticMi  of  SP^'^GARS  radios  is  perfoimed  by  one  or  more  radio  simulation  hosts.  Details  of 
this  simulation  are  given  elsewhere,  but  those  aspects  which  are  pertinent  to  radmon  will  be 
summarized  here.  Each  radio  simulation  host  simulates  the  operation  of  one  or  more  SINCGARS 
radios.  The  simulation  host  receives  digitized  voice  data  from  microphones  in  the  simulated  vehicle 
or  standalone  radio  and  broadcasts  this  data  whenever  the  push-to-talk  button  the  microphone  is 
pressed.  When  the  simulation  hosts  receive  this,  data,  they  play  it  through  the  earphones  or  speakers 
cormected  to  the  those  radios  which  the  simulation  indicates  are  capable  of  receiving  the  signal. 

For  each  simulated  radio,  the  simulation  host  monitms  the  position  of  various  knobs  and  buttons  on  a 
front  panel  These  knobs  and  buttons  allow  the  selection  of  radio  channels,  frequencies,  power 
levels,  and  so  on.  As  the  user  changes  the  settings  of  the  knobs  or  pushes  the  buttons,  the  simulation 
host  notices  these  changes,  incorporates  the  changes  into  the  state  information  it  maintains  and 
broadcasts  a  "transmitter  PDU*  giving  the  new  state  so  that  the  other  radio  simulation  hosts  also 
know  the  state  of  every  simulated  radio  in  the  networic. 

The  radio  simulation  hosts  also  monitor  the  "vehicle  appearance  PDUs*  broadcast  by  the  vehicle 
simulatms  to  deteimine  tlie  position  of  the  vehicles  and  hence  the  radios  in  those  vehicles.  The 
radio  simulation  hosts  also  broadcast  vehicle  appearance  PDUs  for  standalone  radios  which  are  not 
installed  in  vehicles.  The  position  information  contained  in  the  vehicle  appearance  PDUs  allows  the 
signal  attenuation  from  a  transmitter  to  a  potential  receiver  to  be  computed  using  a  radio  propagation 
model  The  attenuation  and  transmitter  power  level  allows  the  received  sigiud  strength  to  be 
determined  for  every  active  transmitter.  From  the  received  signal  strength,  the  radio  tuning,  and  the 
assumed  receiver  sensitivity,  the  radio  simulation  host  can  determine  which  signal,  if  any  a  given 
radio  can  receive. 

The  radio  simulation  host  broadcasts  a  "receiver  PDU"  each  time  the  signal  a  radio  is  receiving 
clianges.  The  receiver  PDU  specifies  which  transmitter  »  being  received  and  its  signal  suength.  In 
the  case  that  all  agnals  are  too  weak  to  be  received,  a  teceivd'  PDU  is  broadcast  qrecifying  which 
transmitter  has  strongest  signal  and  what  the  received  signal  strength  is.  These  receiver  PDUs  are 
not  used  by  the  radio  simulation,  but  are  broadcast  specifically  to  provide  infonnatkrn  for  the  use  of 
data  loggers  and  programs  such  as  radmon. 
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C.3  Data  Acquisition 

Radmon  monitors  the  transmitter  and  receiver  PDUs  broadcast  by  the  radio  simulation  hosts  and  the 
vehicle  appearance  PDUs  broadcast  by  the  vehicle  and  radio  simulation  hosts.  As  each  PDU  is 
received,  the  state  of  the  affected  radio  or  radios  is  changed.  A  radio’s  state  consists  of  the 
following  infrnniadon: 

0  Tuning  (frequency  or  hopset/Iockout  set), 
o  Status.  Oiie  of  the  following: 

nen-existant 

No  TransmitteiPDU  received  fOT  12  seconds. 
inactive  Existant  and  operative  but  not  doing  anything. 
inoperative  The  vehicle  or  its  antenna  has  been  destroyed. 
receiving  The  radio  is  receiving  a  tranmission. 
not-receiving 

The  radio  is  not  ret  eiving  a  transmission  because  the  received  power  is  less 
than  the  noise  power.  Receiver  noise  (sensitivity)  ami  interfering  transmissions 
all  contribute  to  the  noise  power.  The  strongest  transmitter  is  identified  as  the 
transmitter  which  is  not  being  received. 

transtnittingThc  radio  is  transmitting. 

o  Speaker  (who's  talking  if  the  status  is  transmitting). 

0  Antenna  height 

o  Transmitted  power. 

o  Received  power  (if  receiving  or  not-receiving).  _ 

o  Who  is  transmitting  (if  receiving  or  not-receiving). 

o  Geographic  posidon. 

The  new  state  is  found  in  or  entered  into  a  hash  table  aivi  the  pomrY  to  that  hash  table  entry  along 
with  the  time  at  which  the  PDU  was  received  is  appended  to  the  timeline  for  dud  radia  .A  separate 
timeline  is  maintained  for  each  radio.  As  new  radios  appev  in  the  network,  a  riew  dmeline  is 
started  for  that  radio.  The  cunerit  implementation  maintains  all  timelines  in  main  memory.  The 
timelines  comprise  the  raw  data  from  which  radmon  generates  various  displays. 
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C.4  Program  Organization 

Radmon  is  an  X-windows  application  using  the  A/on/  toolkit  The  content  end  layout  of  the  user 
interface  is  q}ecified  using  Afon/  UIL  (User  Interface  Language).  X-windows  resource  file 
specifies  details  of  the  interface  such  as  the  wwds  used  to  label  the  buttons  .4.d  the  text  of  headings 
can  be  determined  at  runtime.  This  accomodates  personal  preferences  a^.  well  as  allowing  foreign 
language  inter&ces.. 

Radmon  is  a  typical  X-windows  application  in  that  it  is  event-driven.  Various  events  such  as 
pressing  a  mouse  button  or  typing  a  key  on  the  keyboard  generates  an  event  The  program 
dispatches  on  the  event  to  perform  an  action  appropriate  to  the  event 

In  addition  to  X-windows  e^  :nts,  radmon  uses  the  UNIX  alarm  clock  signal  to  periodically  wake  up 
and  proress  PDUs  received  from  the  simulation  network.  This  interrupt  occurs  frequently  enough  to 
avoid  data  overruns  from  the  networic,  but  not  so  often  that  an  excessive  amount  of  overhead  is 
incurred  in  such  processing.  The  network  interface  hardware  timestamps  the  incoming  POUs  so  that 
the  delay  befne  they  are  ivocessed  is  inconsequential.  The  timestamps  attached  to  the  PDUs  by  the 
hardware  me  sufTiciently  ar'urate  that  the  causality  of  simulation  events  is  readily  determined.  For 
example,  if  a  receiver  stops  receiving  a  transmission,  radmon  can  determine  if  the  cessation  of 
rec^tion  is  because  the  transmission  stopped  <»'  because  the  signal  was  lost  due  to  propagation 
effects.  In  the  former  case,  radmon  will  receive  a  receiver  PDU  indicating  the  end  of  reception  and 
a  transmioer  PDU  indicating  the  end  of  iraiismission  at  about  the  sanre  time.  In  the  latter  case,  the 
end  of  transmission  will  not  occur  until  much  later. 

As  described  above,  state  changes  reported  by  tlw  incoming  PDUs  are  used  to  construct  a  timeline 
for  each  radio.  These  timelines  constiuite  the  raw  data  from  which  various  displays  are  generated. 

We  will  describe  the  content  of  these  displays  and  other  aspects  of  the  user  interface  to  explicate  the 
remaining  aspects  of  the  operation  of  the  radmon  program. 
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C.5  User  Interface 

The  user  interface  to  radmon  consists  of  a  window  containing  a  pane!  of  buttons  on  the  left  side  and 
a  scrollable  area  on  the  right  The  panel  of  buttons  is  dividel  into  three  areas:  At  the  are  the 
basic  function  buttons  (see  figure  1).  In  the  middle  ate  the  sub-fiinctkm  buttons  for  those  functions 
requiring  siib-functions.  For  example,  the  Stales  function  has  three  sub-functions.  The  bottom 
contains  a  set  (rf  selection  buttons  which  vary  from  function  to  frmction. 


Figure  1:  Radmon  Function  Buttons 


The  frmction  buttons  consist  of  the  following: 


Quit  Exits  the  program.  Accumulated  data  is  discarded. 

Debug  Dumps  debugging  information  useful  to  programmers. 

Reset  Discards  accumulated  raw  data  and  begins  collecting  new  data. 

Read  Reads  raw  data  from  a  file.  A  file  selt^tion  dialog  is  popped  up  and  new  raw  data  is 

read  from  the  specified  fie.  The  old  raw  data  is  discarded.  After  reading  a  file,  data 
arriving  from  the  simulation  network  is  ignoied  and  only  the  data  read  from  the  file  is 
available  for  di.splay  or  analysis. 

Write  Writes  raw  data  to  a  file.  A  file  sdection  dialog  is  popped  up  and  the  current  raw  data 
is  written  to  the  file.  Data  arriving  from  the  simulation  network  while  the  file  is  being 
written  may  be  lost,  but  addidoiul  dau  will  be  added  to  the  raw  data  after  the  write 
operation  is  completed. 

Map  A  connectivity  map  is  displayed.  This  is  described  in  more  detail  below. 

Status  Allows  status  descriptions  for  individual  radios  to  be  displayed.  See  below. 

State  .  Generates  a  statistics  summary.  This  is  described  in  detail  below. 

Traffic  A  traffic  strip  chart  is  displayed.  This  is  described  in  detail  below. 
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C.6  Connectivity  Map  Display 

The  connectivity  map  di^lays  a  map  of  vehicles  with  radios  and  their  coimectivity.  This  map  does 
not  rqxesent  the  actual  vehicle  locations.  In  fact,  usually  the  user  must  reposition  the  vehicles  to 
avoid  clur  jr  on  the  screen.  Each  vehicle  is  repremted  by  a  rectangle  on  the  screen.  These 
rectangles  are  labelled  with  the  vehicles*  bumper  numbers  if  available.  If  a  bumper  number  is  not 
available,  that  vehicle’s  rectangle  is  labelled  with  the  vehicle  id  number.  The  background  color  of 
the  vehicle  rectangles  is  normally  olive  drab,  bd  is  changed  to  a  grayish  olive  for  vehicles  which  are 
^pvently  non-existant  (no  vehicle  appearance  n)U  for  mote  than  12  seconds).  Hgure  2  shows  a 
typical  conoectivity  map. 


Hfiie  2;  Kadio  OoBneedvay  Hqt 
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Attached  to  either  end  of  the  vehicle  rectangle  is  a  rectangle  for  each  radio  the  vehicle  contains. 

The  ’A”  radio  is  on  the  left  side  and  the  'B”  radio  is  on  the  right  Vehicles  with  no  "B"  radio  have 
no  rectangle  on  the  right  side.  Again,  the  background  color  of  the  rectan^  denotes  the  existance  of 
the  radio.  It  is  possible  for  a  non-existant  vehicle  to  have  existant  radios  and  vice-versa  although 
this  is  anomalous  and  usually  transient  A  non-existant  radio  on  an  existant  vehicle  is  usually  due  to 
the  radio  simulator  for  that  radio  being  inoperative.  A  non-existant  vehicle  with  an  existant  radio  is 
also  transitary  since  tlie  radio  simulator  for  that  radio  will  note  the  missing  vehicle  appearance  PDUs 
and  cease  transmitting  transmitterPDUs  for  the  radios  of  that  vehicle. 

The  background  color  of  the  radio  rectangle  also  denotes  whether  it  is  receiving,  not-receiving. 
transmitting,  or  doing  nothing.  A  ttarsmitting  radio  is  colored  green,  a  receiving  radio  is  colored 
magenta,  a  not-receiving  radio  is  colored  red,  and  a  radio  doing  nothing  is  colored  olive-drab. 

The  vehicle  rectangles  are  initially  placed  on  the  connectivity  map  in  a  position  correqxxiding  to 
their  relative  positions  in  the  world.  That  is  a  given  vehicle  will  be  positioned  on  the  connectivity 
nu^  to  the  left  of  all  vehicles  which  are  more  westerly  than  itself  and  will  be  positioned  above  ail 
vehicles  which  are  more  southerly  tlian  itself.  However,  the  distance  betweai  vehicles  on  the  map  is 
not  proportional  to  their  actual  separation.  This  is  done  because  vehicles  are  often  clustered  into  a 
few  widely  separated  groups  with  the  result  that  ail  the  rectangles  for  vehkies  in  a  group  end  up 
being  displayed  with  neatly  identical  positions. 

The  vehicle  rectangles  may  be  moved  by  simply  positioning  the  r.K)use  over  a  vehicle  rectangle, 
depressing  the  left  button,  dragging  the  rectangle  to  a  new  position,  and  releasing  the  button. 

The  state  of  connectivity  between  pairs  of  radios  is  refHesented  by  drawing  a  lightning  bolt  between 
the  radios.  The  shape  and  color  of  this  bolt  represents  the  state  of  connectivity  between  the  r^ios. 
Radios  which  are  not  anted  to  the  same  frequency  or  ht^set  have  nothing  drawn  between  them.  For 
radios  which  are  tuned  the  same,  but  which  have  nevor  transmitted  b  each  other  (while  the  radmtm 
program  has  been  running},  di-;  bolt  is  an  empty  outline.  For  radios  which  have  successfully 
transmitting  in  one  direction  but  nc.-sr  oansmitted  in  the  other  direction,  the  boh  is  green  and 
pointed  on  only  me  end  (the  receiving  end).  For  radios  which  have  successfuUy  transmitted  both 
ways,  the  bolt  is  green  and  pointed  on  bc>th  ends.  For  radios  which  have  failed  to  hear  a  transmitter, 
the  bolt  is  colored  red  on  the  end  which  has  failed  to  receive  (both  ends  aie  colored  red  if  neither 
has  heard  the  other).  For  transmissions  that  are  currently  active,  the  bob  is  striped  green  and  Mack 
and  animated  in  die  direction  of  transmission.  For  transmissions  that  ate  canendy  active  and  fa 
which  lecqition  has  been  preempted  by  another  simultar;ous  transmissioii,  the  bob  is  coined  nmge. 
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The  display  is  normally  maintained  in  real  time.  As  each  radio  changes  state,  the  display  is 
changed.  In  particular,  at  any  moment  the  map  display  shows  who  is  muism'tting  and  receiving  and, 
mote  unportantly,  who  is  not.  During  periods  of  rapid-fire  communication,  the  display  may  lag 
behind.  This  h^jpens  for  two  reasons:  First,  the  display  update  takes  time  and,  second,  we  desire  to 
display  every  state  change  for  a  minimum  interval  to  insure  its  visibility.  The  lag  in  the  display  has 
a  minimal  effect  on  the  acquisition  of  raw  data. 

The  map  di^lay  can  also  be  frozen  and  stepped  from  one  state  change  u  the  next  or  stepped  to  the 
next  anomalous  state.  Anomalous  states  are  those  containing  red  or  orange  bolts.  This  string 
feature  is  best  used  in  conjuncton  with  the  traffic  display  (see  below).  When  the  trafric  display 
mark  is  moved  and  the  connectivity  map  display  frozen,  then  the  connectivity  display  shows  the 
connectivity  at  the  time  selected  in  the  traHic  display.  In  Uiis  way  the  cmmectivity  display  can  be 
used  to  review  earlier  anomalies. 
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C.7  Status  Display 

When  the  "status”  button  is  selected,  selection  buttons  for  every  radio  ate  presented.  Seixdng  the% 
buttons,  causes  a  box  for  each  selected  radio  to  be  displayed  (figure  3).  This  box  describes  the  state 
of  the  radio  and  is  updated  whenever  the  state  changes.  Again,  if  the  tiaific  display  is  frozen  the 
status  boxes  display  the  state  of  the  radios  at  the  time  selected  b>  the  traffic  mark.  Whenever  the 
information  in  a  box  changes,  the  changed  infonnation  is  displayed  in  Uue.  Old  information  is 
shown  in  black. 


Figure  3:  Status  Di^lay 


The  selection  buttons  use  a  Motif  selection  policy  known  as  extended  selectifln.  This  means  that  if 
the  tiwuse  is  positioeed  over  t  button  and  the  left  mouse  button  is  clicked,  tim  button  bectnnes 
selected.  Multiple  buttons  may  be  selected  by  dragging  through  several  buttons.  Normally,  the 
previoudy  selected  buttons  ate  rleated  a:  each  selection  staru.  This  action  is  omitted  if  the  control 
key  is  hdd  down  which  the  mouse  button  is  pressed.  In  this  case  if  the  button  where  the  selection 
stmts  was  already  selected,  dien  the  action  deselects  ail  the  buttons  which  ate  dragged  over.  The 
most  useful  actiuis  are  to  click  on  single  buttons  to  select  a  radio  for  scuiis  display,  (hag  from  the 
first  button  tn  the  last  to  select  all  radios,  and  to  control-clkk  on  individual  butttms  tc  either  select 
or  deselea  them  . 
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C.8  State  Display 

Tlw  state  display  presents  a  summary  of  radio  activity.  When  the  "State”  button  is  selected.  A 
panel  of  three  sub-function  buttons  ^rpears.  These  buttons  do  the  following: 

Presents  radio  selection  buttons.  Summary  information  is  is  presented  for  the  radios 
selected  from  this  panel.  These  are  selection  buttons;  information  about  radios  which 
are  not  selected  is  simply  not  presented. 

Plemts  attribute  selection  buttons.  The  attributes  selected  by  these  buttons  determine 
which  states  are  included  in  the  summary.  These  ate  filtering  buttons;  attributes  which 
ate  not  selected  are  igixaed  when  distinguishing  one  state  from  another.  The  statistics 
for  states  which  differ  only  in  unselected  attnbutes  ate  combined. 

Presents  status  type  selection  buttons.  The  selected  status  types  are  included  in  the 
summary.  These  are  also  a  selection  buttons;  information  about  states  which  have  a 
status  which  is  not  selected  are  simply  not  prer  mted. 

The  state  display  consists  of  one  or  more  raws  of  infmnation.  Each  row  summarizes  one  or  more 
states  of  one  cr  more  radios.  Each  colunn  contains  the  value  of  an  attribute  or  statistic  for  those 
states.  The  statistics  consist  of  the  following; 

%  The  percentage  of  all  time  that  is  iqrent  in  this  nate.  When  radios  are  individually 

summarized  (radio  attribute  selected)  percental,  ate  computed  separately  for  each 
radio  and  thus  the  numbers  in  the  column  for  one  radio  will  sum  to  100  (small 
rounding  enois  may  occur).  When  the  radios  are  aggregated  (radio  attribute  not 
selected),  the  sum  of  all  percentages  will  agairt  sum  to  100. 

Count  The  number  of  times  a  radio  (or  ail  radios)  was  (were)  in  this  state. 

Avg  Tune  The  average  duration  of  time  spent  in  this  state. 

Max  Time  The  maximum  duration  of  time  spent  in  this  state. 

When  an  attnbme  is  omiUKl  all  the  states  which  are  identical  except  for  that  attribute  ate  tombined. 
Statistics  are  combined  as  follows:  Count  is  added,  total  time  in  the  combined  state  is  coumputed 
by  adding  the  times  fiom  the  individual  states  and  thus.  %  is  added.  Avg  Time  is  computed  fiom 
the  combined  total  time  and  combined  count  Max  Time  is  the  maximtm  duration  of  time  spent  in 
any  (rf  the  combined  states.  In  computing  Max  Time,  the  duration  of  time  spent  in  a  state  is 
determined  independent  of  which  states  might  be  combined.  .Therefore,  a  transition  fiom  one  state  ro 
another  with  which  it  is  being  combined  still  counts  as  a  slate  change;  the  durations  ve  not  added. 
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C.9  Traffic  Display 

The  traffic  di^lay  consists  of  a  number  of  hMizontal  lines  of  data  representing  the  state  of  radios  as 
a  function  of  time  (see  figure  4).  Four  states  are  distinguished:  non-existant/inoperaiive,  inactive, 
transmitting,  and  receiving.  The  non-existant/inoper?uveAH)t-receiving  state  is  is  rqiresented  by  a 
line  with  the  same  color  as  the  background  (which  is  therefore  invisible).  The  inactive  state  is 
represented  by  a  thin  black  line.  The  oansmitting  state  is  represented  by  a  thick  green  ILne.  The 
receiving  state  is  represented  by  a  thick  magenta  line. 


Figure  4:  Traffic  Display 

When  the  traffic  display  is  selected,  two  sub-function  buttons  appear 

Tuning  Permits  transmissions  on  particular  frequencies  or  hopsets  to  be  highlighted. 

Transmissions  a.nd  receptions  for  unselected  timings  are  shown  in  black  rather  than 
color.  Selecting  no  tuning  buttons  is  equivalent  to  seJociing  them  all. 

Radio  Selects  which  radios  are  included  in  the  di^lay. 

The  visible  portion  of  the  traffic  display  shows  the  data  for  some  particular  portion  of  time  and 
.  normally  sqolls  to  keep  the  presem  time  at  the  right  edge  of  the  display.  Arrows  at  either  end  of 
the  strip  allow  the  display  to  be  scrolled  leA  or  right  to  expose  a  different  fm  <4  the  data.  In 
addition,  a  scrollbar  at  the  bottom  of  the  display  allows  traversing  the  data  by  larger  amounts:  The 
scrollbar  represents  the  entire  available  data  and  the  slider  represents  the  visible  portion  of  the  data. 
The  slider  may  be  dragged  to  the  region  of  interest.  Gicking  the  left  button  to  the  left  of  the  sbder 
moves  the  slider  one  page  earlier  in  the  data;  clicking  the  left  button  to  the  right  of  the  slider 
advances  the  slider  by  one  page.  Gicking  the  left  button  in  the  left  arrow  moves  the  slider  a  small 
amount  earlier  in  the  data  and  clicking  the  left  buuon  is  the  right  arrow  moves  the  slider  a  small 
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amount  later  in  t|)e  data.  Depressing  the  shift  key  while  clicking  in  either  airow  moves  the  slider  all 
the  wa:-  to  either  the  beginning  of  the  data  (left  airow)  or  the  end  of  the  data  (right  arrow).  Buttons 
allow  zooming  in  or  out  to  change  the  scale  factor  of  the  display. 

TLe  traffic  display  allows  a  region  of  the  display  to  be  delimited  using  the  mouse.  If  the  left  mouse 
button  is  pressed  while  posidoned  over  the  strip  chan  a  mark  iplaced  at  that  point  in  time  and  shown 
as  a  blue  vertical  line  over  the  chart  If.  after  the  button  is  pressed,  the  mouse  is  moved  left  or  right 
and  then  released,  a  second  mark  is  made  and  again  depicted  as  a  blue  vertical  lir.e.  The  "Zoom  in' 
and  *Zoom  Out*  buttons  apply  lo  the  region  thus  delimited.  'Zoom  in*  expands  the  image  to  make 
the  delimited  legioo  fit  between  the  left  and  right  edges.  *Zooai  Out*  shrinks  the  image  to  make  the 
entire  picture  appear  between  the  delimited  extremes.  When  no  region  has  been  delimited,  the  zoom 
buttons  zoom  by  a  factor  of  two. 

The  inc*  button  causes  the  entire  recorded  data  to  be  compressed  into  the  display. 

When  the  mark  is  positioned  in  the  traffic  display,  the  display  is  frozen  and  automatic  scrolling 
ceases.  The  display  will  remain  frozen  until  the  Thaw*  button  is  selected.  The  display  may  also  be 
frozen  without  setting  the  mark  by  selecting  the  *Fieeze*  button. 

At  very  small  scales,  the  duration  of  transmissions  or  receptions  becomes  very  short  The  traffic 
display  is  biased  toward  showing  transmissions  in  preference  to  reception  or  inactivity.  Therefore,  at 
very  small  scales,  the  display  will  be  mostly  green. 
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C.10  Customizatiun 

Most  of  the  factcxs  controlling  the  operation  of  radmon  are  specified  as  X-windows  resources  and 
may  be  found  in:  /simnet/data/radmon/radmon.  res.  These  values  may  be  overridden  using 
the  -xim  option  in  the  command  invoking  radmoo.  For  example: 

radmon  -xrm  ' *exerciaeID:  7' 

Sets  the  exerdselD  filter  parameter  so  that  radmon  ignores  all  PDUs  which  are  not  part  of  exercise 
7. 

radmon  -xm  ' radmon* status. hilltedColor:  green-' 

Changes  the  cokr  used  to  display  new  values  in  the  .status  displays. 

The  following  is  a  list  of  the  resources  for  which  values  are  specified  in  radmon.res.  Those 
resources  which  are  obvious  or  which  arc  excessively  complicatfd  are  lUt  described.  Also,  ail 
resource  .lames  begin  with  radmon*  which  has  been  omitted  for  brevity. 

geometry:  800x600 

The  size  and  position  of  the  raduron  display  window. 

cxerciselD:  255 

The  exercise  ID  of  saniilation  PDUs  which  are  monitored  by  radamn. 

shadowThickaetK  2 

The  thickness  of  the  shadow  around  buttons. 

Butfonl^aafanatelaterval;  150 

The  interval  (in  milliseconds)  between  updates  during  scrolling  of  buttons. 

radmoa.ooUaeLabelFonnst:  SINCGARS  Radio  Monitor  —  %v\nOnl!ne 

Data\nMoait' wing  by  %H  (%E)  on  %d  %M 
%y  at  %b:5>m:%s  ' 

This  is  the  format  used  for  composing  the  main  title.  The  fcllowing  escape  sequences  are 
used: 

%H  Host  name  —  the  name  of  the  bust  on  which  radmoi  is  ruining. 

%B  The  ethemet  address  on  the  simulaiion  ncrwoit. 

%F  the  name  of  the  data  file  being  perused  or  'oMCne*  U  the  dua  is  being  gathered  online. 
%v  The  radmon  version  mirnber. 

%t  The  time  at  which  the  dau  was  acquired. 

%w  The  day  of  the  week. 

%M  The  momh. 

%d  The  day  of  the  month. 
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%h  The  hour. 

%m  The  minute. 

%s  The  second. 

%Y  The  four-digit  year. 
%y  The  two-digit  year. 

radBon.ii<nineLabdFonnat: 


SINCGARS  Radio  Monitor  —  %v\nData 
From  File:  %F\nMonitored  by  %H  (%E)  on 
%d  %M  %y  at  %h:%m:%s 


This  is  the  format  of  the  main  dtk  for  dam  which  comes  from  a  file.  The  escape  sequences 
are  the  same  as  for  the  online  format 


rcservcArrowSpaoe:  False 

Specifies  that  the  sooUing  button  lists  should  reserve  a  space  for  scrolling  arrows  even  when 
they  are  not  needed  for  a  particular  list 


font:  *helvetka-bold-r-normal— ^14*75*75* 

The  font  used  for  text  labels. 

fontUst:  *helvetica-bold-r-normal — 14*75*75* 

The  fona  u.cd  for  text  labels.  (No  labels  currently  use  more  than  one  font). 

BnttonLJwrderWidth:  ,  0 

The  width  of  the  border  around  button  labeb. 

fiuction*battottSJiHmColHmBt:  3 

The  number  of  columns  used  for  the  function  button  list 

r«nctioa*battott3jwws:  3 

The  number  of  rows  used  for  the  function  button  list 

fkaction*bnttonsJiilitePolicy:  H1L1TE_WHEN_SELECTED 

Causes  buttons  to  be  highlighted  only  when  selected.  Merely,  passing  the  mouse  over  a 
bmton  will  not  cause  k  to  be  highli^ied. 

fkactioo*battota.qnit: 

The  text  of  the  label  on  the  quk  button. 

fiuKtk«*battaan,dnaip: 

The  text  of  the  label  on  the  debug  button. 

fknctioa*battonajTad: 

The  text  of  the  label  on  the  read  button. 

fkaction*b«ttons.write: 

The  text  of  the  label  on  the  write  button. 

fkactioo*bnitonsjresc<: 

The  text  of  the  label  on  the  reset  button. 

fWactioa*bottoaa,map:  Map 


Qak 

Debug 

Read 

Writ* 

Reset 
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The  text  of  the  label  on  the  map  button. 
fiuictioa*buttons.state:  States 

The  text  of  the  label  on  the  states  button. 
ruiictk>a*buttods.trafnc:  Traffic 

The  text  of  the  label  on  the  traflic  button. 
fiiactiop*bBttoDSJ8tatas;  Status 

The  text  of  the  label  on  the  status  button. 
fBiictNM.width:  200 

The  width  of  the  atea  for  fiuictian  buttons. 
fuiiction.Spadng:  3 

The  spacing  between  function  buttons. 

state_attribnte_fnnctioiis*labellJabelStriBg:  State  DisplayVnAttribnte  Choices 

The  label  for  the  state  attribute  sub-function  button  list. 
state_attribate_fnBCtioiis*selcctionPolic7:  EXTENDED_SELECT 

The  selection  policy  for.  the  attribute  selection  buttons. 
state_attribntcJunctioBS*haitePolicy:  HI1JTE,WHEN_SELECTED 

See  above. 

state_status_fuiictioiis*labcllJabelString:  State  Dispiay\nStatns  Choices 

The  label  for  the  state  display  status  selection  button  list. 
state_statB8_fBnctioas*sclectkNiPolicy:  EXTENDED_SELECT 

state_sUtiis_fuDCtioas*bilitePolicy;  HHJTE^WHEN.SELECTED 

state_radio_functions*labellJabclString:  State  Display\nRadio  Choices 

stale_radio_fkiiKtioos«selectkMiPoiicy:  EXTENDED^SELECT 

Uatc_radioJuactfci««hiUtcPoiicy:  HlUTE.WHENJELECtED 

stat«s_fitactioas*labcllJabclStrhig:  Status  Dbpiay\aRadlo  Chokes 

statua_fiiactioiis*aelectioaPolicy:  EXTENDEDJELECT 

statiu_fbi!et}oiis«liiiitePolky:  H1LXTE_WHEN_SELECTED 

trafne_radio_fkiBCtiofM*faibeLlabelString;  Traflic  Dlsplay\BRadio  Chokes 
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trainc_radio_Ainctiotis*selectionPolicy: 

trafnc_radio_functions*hiUtePolicy: 

trafnc_tiiniDg_functioiis*labcLlabelString: 

traflk_tiuiing_functioas*selectionPolk7: 

trafnc_tnning_rdnctioas*hilitePOliC7: 

map_ftinctions*labeil.labelString: 

■iap_fiiiictioas*selectmnPolk7: 


EXTENDED_SELECT 

HIUTE_WHEN_SELECTED 

Traffic  Display\nTuning  Choices 

EXTENDED_SELECT 

HIUTE_WHEN_SELECTED 

Connectivity  DisplayVnRadio  Choices 

EXTENDED_SELECT 


nap_ftinctiofis*hi]itePolicy: 


HILITE_WHEN_SELECTED 


iiiap_ffinctioas*rows:  10 

The  number  of  rows  of  buaons  in  the  selection  lists. 
statoiJiQitedCokr:  blue 

The  color  of  changed  status  values  in  staois  boxes. 
statmjuhiUtedColor; 

i 

The  color  of  unchanged  statu.*,  '.'slues. 
statits_rc.width:  300 


The  width  of  a  status  box. 


statitf^rcjshadowThicfciicsB: 

The  status^  widget  composes  the  status 
Change  th^  resources  at  your  pnil. 

statits_rc.catryBordcr: 


0 


box  from  a  heading,  a  separator  and  a 


list  of  labels. 


0 


a(atns_rc.borderWidUi: 


0 


statii8_rcjMlljitttMargln: 


False 


statos^rcJBarginHei^t: 
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status_rcjnarginWidth:  .  0 

statiis_’CJsepp.margin:  3 

The  q>ace  around  the  separator  in  the  status  display. 
status_rcJieadingJ>orderWidth:  0 

The  width  of  the  border  around  the  heading  string. 
statiHi_rc.taeadingxloseJabelString:  Close 

The  label  in  the  close  button  of  a  status  box. 
statiis_rcJK)d7JnarginWidtli:  0 

statiu_rcJK)d7JnargmHeight:  0 

status_rcJ>od7xpacing:  -4 

The  spacing  between  lines  in  the  status  box.  A  negative  spacing  places  the  lines  a  liule 
closer  together  than  the  default  spacing.  If  this  is  too  negative,  ascenders  or  descenders  may 
be  lost.  This  may  need  to  be  adjusted  if  the  font  is  changed. 

statiis_rciK>d7.XmLabeiGadget.labelStnng:  From:  Vehicle  101,  Radio  A - 

A  prototype  string  used  for  sizing  the  labels  in  the  status  box. 

status^rcJbodyJfiaLabcIGadgHjiiarginHeight:  0 

statiis_rcJKidy.XmLabeKjiadgetborderWidth:  0 

statiis_rcJ>ody.XmLabeKjadgetrecoaiputeSize:  False 

statiis_rcJ>ody.XmLabeLlabclString:  From:  Vehicle  Idl,  Radio  A - 

statua_rcJ>ody.Xm^beLmarginHeigbt:  0 

statoa^^rcJMdyJCmLabeLborderWidth:  0 

atatiia_rcJmdyJCmLabdJ«computeSize:  False 

trafncforokwidth:  485 

The  width  of  n  trafTic  display. 
tndncform.Spacing:  S 

The  spacing  betwm  dements  of  the  tralTic  display. 
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traflic/omi.inarginWidth:  5 

The  side  niargins  for  the  elements  of  the  traffic  display. 
trafncJinrm.niarginHeight:  5 

The  top  and  bottom  margins  for  the  elements  of  the  traffic  display. 
tnfliclDnn.closeJabelString:  Close 

The  label  on  the  "close*  button  in  a  traffic  display. 
trafncJ’onnjooai_inJabclStriDg:  Zoom  In 

The  label  on  the  "zoom  in*  button. 

bvfncJioimzoomjoatJabelString:  Zoom  0(>t 

The  label  on  the  "zoom  out*  button. 
trafflcJ'omi.fitJabelString:  \  F1t\ 

The  label  on  the  "fit*  button. 

trafncJ’onnJIvezeJabelString:  Fireeze 

The  label  on  the  "freeze*  button. 
trafficJ'ora.unfreeze.labcIString:  Thaw 

The  label  on  the  "thaw*  button. 

traflicfoat:  •-helvetica-niedium-r-normal->'-10~*-75-75* 

The  font  for  labels  in  the  traffic  display.  . 
trafnciransmitBarCokm  green 

The  color  of  a  traffic  bw  during  transmission. 

trafncbransmitBarHeight:  5 

traffirjrcceiveBarColon  magenta 

The  color  of  a  traffic  bar  during  transmission. 

trafficrecciveBarHeigh::  5 

The  height  of  a  traffic  bar  during  transmission. 

IrafllcjiotReceiveBarColor:  red 

The  color  of  a  traflic  bar  dming  nonrecepdon. 

trafIkjiotReceiveBarHeight:  0 

The  height  of  a  traffic  bm  during  non-receptioo. 

trafflcjiBtuncdBarColor:  dark  slate  grey 

The  color  of  a  traffic  bar  during  transmission  or  reception  not  on  one  of  the  selected 
frequencies  or  hopsets. 

tra/fk.untnnedBarHcight:  5 

The  height  irf  a  traffic  bar  dining  transmission  or  reception  not  on  one  of  the  selected 
BequeiKies  or  hopsets. 
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trafncsilentBarColon  dark  slate  grey 

The  color  of  a  traffic  bar  during  silence. 
trafncxursorColor:  medium  blue 

The  color  the  cursws  in  the  traffic  display. 
traflic_sab_functionsjnnerJabelJabelString:  Traffic 

The  label  on  the  traffic  sub-functicn  menu. 

.tniffic_sab_fiinctionsJnnerXistJiilitePolicy:  HILITE_WHEW_SELECTED 

The  traffic  sub-function  button  hilite  policy. 
traffic_8ub_fiuKtionsJnnerXistrows:  3 

The  niunber  of  rows  of  traffic  sub-ffmction  buttons. 
traffic_sub_fuuctionsJnnerXistJiumColnmns:  2 

The  number  of  columns  of  traffic  sub-function  buttons. 
state_sub_functionsJnner.labeLlabelString:  State 

The  label  on  the  state  sub-function  menu. 

state_,sub_functionsJnner.Li$tJiilitePoiicy:  H1LITE_WHEN_SELECTED 

The  state  sub-function  button  hilite  policy. 
state_sub_functionsJnner.Listxows:  3 

The  number  of  rows  of  state  sub-function  buttons. 
sub_functioa_rc.*Jnner.width:  188 

The  width  of  the  sub-function  button  area. 
sub_functioa_rc.*JnnerJieight:  SH) 

The  height  of  the  sub-function  button  area. 
stateJarm.Spacing:  5 

The  spacing  between  elements  of  the  state  display. 
state.rormjnarginWidth:  5 

The  side  margins  for  elements  of  the  state  display. 
stateiionajnarginHeight:  5 

The  top  and  bottom  margins  for  elements  of  the  state  display. 
stateJormXodyjresizePolicy:  RESIZE.NONB 

The  size  of  the  state  di^lay  is  determined  by  its  contents  (rather  than  vice-versa). 
stateJarmJabelJabelString:  Radio  Statistics 

The  label  on  the  state  display 

stateibrmxkMeJabeiString:  Close 

The  labd  on  the  'close*  button  of  the  state  display. 
state.roat:  •heivetica-medium-r-nonnal— 12*75*75* 

The  font  used  in  the  state  display. 
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sUte*body.width;  500 

The  default  width  of  die  state  display.  In  practice,  the  width  is  detennined  from  the  cements. 

state^bodyanarsinWidth:  0 

The  side  margins  Li  the  data  portion  of  the  stae  di^iay. 

state*bodyjnar{7‘>iHeight:  0 

The  top  and  bntaxn  margins  in  the  data  portion  of  the  state  display. 

map.vchicleColor:  #809040 

The  color  of  vehicle  and  inactive  radio  rectangles  in  the  map  display  (dark  olive  drab). 

mapjiuiniianyPIacedVehicieCoior:  #90a000 

The  cohx  of  manually  placed  vehicle  and  inactive  radio  rectangles  in  the  m^  display  (light 
olive  drab). 

mapJionExistantColon  #9Ga080 

The  color  of  non-existant  vehicle  and  inactive  radio  rectangles  in  the  m^  display. 

map.tninsmittingColon  green 

The  color  of  transmitting  radio  rectangles  in  the  map  display. 

mapj'eceivingColor:  magenta 

The  color  of  receiving  radio  rectangles  in  the  map  display. 

mapjiotReceivingCoion  red 

The  color  of  not-receiving  radio  rectangles  in  the  map  di^lay. 

map.unconaectedColor:  red 

The  color  of  bolts  between  unconnected  radios. 

mapxonnectedColon  green 

The  color  of  bolts  between  connected  radios. 

mapxonflictColor:  orange 

The  cdor  of  bolts  between  radios  when  a  transmission  conflia  occurs. 

mapj-eceivingOCoior:  green 

nrapjaceivinglColor:  green 

HupjrcceivinglColor:  black 

mapxcccivingdCoktr:  black 

One  of  the  colors  of  bolts  between  radios  during  reception.  The  bolt  is  sniped  with  a 
sequence  of  four  colors.  Animation  is  achieved  by  cycling  the  color  imp  so  ^h  stripe  is 
colored  by  each  of  the  four  colors  in  sequence. 

mapjintnnedStylc:  BLANK 

The  style  of  the  lightning  bolts  benveen  radfos  not  tuned  the  sairie. 

mapJancdStylR  HOLLOW 

The  style  of  the  lighming  bplts  between  radios  tuned  the  same  but  for  which  no  transmission 

have  occurredM 

mapjincrmnectcdStyle: 


FILLED 
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The  style  of  the  lightning  bolts  between  radios  that  are  not  able  to  communicate. 

mapxonnectedStyle:  FILLED 

The  style  of  the  lightning  bolts  between  radios  that  are  able  to  communicate. 

mapxonflictStyle:  FILLED 

The  style  of  the  lightning  bolts  between  radios  for  which  communication  was  interfoed  with 
by  another  simultaneous  transmission. 

mapjeceivingStyle:  ANIMATE 

The  style  of  the  lightning  bolts  between  radios  during  reception. 

Dapioreground:  black 

‘  The  color  of  outlines  and  other  foreground  objects  in  the  map  display, 

mapjuimationlnterval:  jlOO 

The  interval  between  color  map  changes  used  for  animation. 

mapibrm.Spacing:  5 

The  ^)acing  between  separators  and  other  elements  of  the  map  dis{day. 

mapJbrnijnarginWidth:  .5 

The  side  margi*i  of  separators  and  other  elements  of  the  map  display. 

mapJ'cnnjnarginHeight:  5 

The  top  and  boaom  margins  of  separators  and  other  elements  of  the  map  display. 

inapJ'onn.body.resizePolicy:  RESIZE_NONE 

The  size  of  the  map  is  constant 

mapJbrmJabeLlabelString:  Radio  Connectivity  Map 

The  text  of  the  label  on  the  map  display. 
mapJ'orm4;loseJabelStruig:  Close 

The  text  of  the  label  on  the  "close*  button. 
mapJ'Grm.step.labelString:  Step 

The  text  of  the  label  on  the  "step"  button, 
map Jbmjittomaly. labelstring:  Next  Anomaly 

The  text  of  the  label  on  the  "next  aiKxraly*  button. 
mapJ’ormit’eezeJabelString;  Free» 

The  text  of  the  label  on  the  "freeze*  button. 
mapJ'omi.unfreeze.labelString:  Thaw 

The  text  of  the  label  on  the  "thaw*  button, 
iiiap*fona.width:  512 

The  width  of  the  map  display. 
niap*bodyJieight:  384 

The  height  of  the  map  di^lay. 
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map*bodyjnargin  Width: 
map*l>odyjnarginHeight: 
map*body*fomi.marginHeight: 

.  map'*bod]r*f(Mmmargin  Width: 
inap*body*fora.spadng: 

.  nup*body*fonn.XmSeparatorJM>rder  Width: 
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0 

0 

0 

0 

0 

0 


niap*body*form.XmSepamtorGadgethorderWidth:  0 


niap*hody*rorm.XmLabeLmarginHeight:  0 

nap*body*form.XmLabelGadgetjnarginHeight:  0 

niap*body*ronn.XmLabeLmarginWidth:  0 


map*hody*rorm.XmLabelGadgetjnarf;inWidth:  0 

radm(Hi.disp*flIe.dirMask:  *j’admon 

The  pattern  for  scanning  a  directory  of  radmon  data  files.  Files  matching  this  pattern  a 
avail^le  for  reading  or  overwriting. 

functions.inDeri.istadjustLast:  false 

geaeraUcroUedWindOwMarginWidth:  5 

gencraLwidtht  <50 

The  width  at  the  general  di^lay  area. 
generaUieight:  500 

The  height  (tf  the  general  display  area. 

Srorfc.widtli:  <20 

The  width  of  the  woifc  area  within  the  general  display  area. 
workJieight:  10 


. . 
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'Tie  height  of  the  woric  area  within  tne  general  display  area. 


workjnargin  Width: 

10 

workjnarginHeight: 

10 

work.spacing: 

5 

work  J>order  Width: 


0 


